home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1997 #1 / Amiga Plus CD - 1997 - No. 01.iso / pd / programmierung / mesa-1.2.8 / samples / readme < prev    next >
Text File  |  1996-05-27  |  14KB  |  563 lines
  1. /*
  2.  * Copyright (c) 1991, 1992, 1993 Silicon Graphics, Inc.
  3.  *
  4.  * Permission to use, copy, modify, distribute, and sell this software and
  5.  * its documentation for any purpose is hereby granted without fee, provided
  6.  * that (i) the above copyright notices and this permission notice appear in
  7.  * all copies of the software and related documentation, and (ii) the name of
  8.  * Silicon Graphics may not be used in any advertising or
  9.  * publicity relating to the software without the specific, prior written
  10.  * permission of Silicon Graphics.
  11.  *
  12.  * THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF
  13.  * ANY KIND,
  14.  * EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
  15.  * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  16.  *
  17.  * IN NO EVENT SHALL SILICON GRAPHICS BE LIABLE FOR
  18.  * ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
  19.  * OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  20.  * WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
  21.  * LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
  22.  * OF THIS SOFTWARE.
  23.  */
  24.  
  25. accum - Accumulation test.
  26.     - RGBA, SB/DB (SB default), DR/ID (ID default).
  27.     - cmd line options:
  28.     -sb    Single buffer mode.
  29.     -db    Double buffer mode.
  30.     -dr    Direct render mode.
  31.     -ir    Indirect render mode.
  32.     - keys:
  33.     ESC    Quit
  34.     1    Use filled polygon mode.
  35.     2    Use outlined polygon mode.
  36.  
  37. bitmap1 - Bitmap test.
  38.     - RGBA/CI (RGBA default), SB/DB (SB default), DR/ID (ID default).
  39.     - cmd line options:
  40.     -rgb    RGBA mode.
  41.     -ci    Color index mode.
  42.     -sb    Single buffer mode.
  43.     -db    Double buffer mode.
  44.     -dr    Direct render mode.
  45.     -ir    Indirect render mode.
  46.     - keys:
  47.     ESC    Quit.
  48.  
  49. bitmap2 - Bitmap test.
  50.     - RGBA/CI (RGBA default), SB/DB (SB default), DR/ID (ID default).
  51.     - cmd line options:
  52.     -rgb    RGBA mode.
  53.     -ci    Color index mode.
  54.     -sb    Single buffer mode.
  55.     -db    Double buffer mode.
  56.     -dr    Direct render mode.
  57.     -ir    Indirect render mode.
  58.     - keys:
  59.     ESC    Quit.
  60.     1    Toggle display list mode.
  61.     2    Toggle color animation mode.
  62.  
  63. copy - Pixel copy test.
  64.     - RGBA, SB/DB (SB default), DR/ID (ID default).
  65.     - cmd line options:
  66.     -sb        Single buffer mode.
  67.     -db        Double buffer mode.
  68.     -dr        Direct render mode.
  69.     -ir        Indirect render mode.
  70.     -f <file name>    RGB image file.
  71.     - keys:
  72.     ESC        Quit.
  73.     Z        Increase zoom factor.
  74.     z        Decrease zoom factor.
  75.     - mouse input:
  76.     Left        Copy location.
  77.  
  78. cursor - Cursor test.
  79.     - RGBA/CI (RGBA default), SB/DB (SB default), DR/ID (ID default).
  80.     - cmd line options:
  81.     -rgb    RGBA mode.
  82.     -ci    Color index mode.
  83.     -sb    Single buffer mode.
  84.     -db    Double buffer mode.
  85.     -dr    Direct render mode.
  86.     -ir    Indirect render mode.
  87.     - keys:
  88.     ESC    Quit.
  89.     SPACE    switch cursor color.
  90.  
  91. depth - Z buffer test.
  92.     - RGBA/CI (RGBA default), SB/DB (SB default), DR/ID (ID default).
  93.     - cmd line options:
  94.     -rgb    RGBA mode.
  95.     -ci    Color index mode.
  96.     -sb    Single buffer mode.
  97.     -db    Double buffer mode.
  98.     -dr    Direct render mode.
  99.     -ir    Indirect render mode.
  100.     - keys:
  101.     ESC    Quit.
  102.     1    Toggle anti-aliased mode.
  103.     2    Toggle stipple mode.
  104.  
  105. eval - Evaluator test.
  106.     - RGBA, SB/DB (SB default), DR/ID (ID default).
  107.     - cmd line options:
  108.     -sb    Single buffer mode.
  109.     -db    Double buffer mode.
  110.     -dr    Direct render mode.
  111.     -ir    Indirect render mode.
  112.     - keys:
  113.     ESC    Quit.
  114.     LEFT    Rotate.
  115.     RIGHT    Rotate.
  116.     UP    Rotate.
  117.     DOWN    Rotate.
  118.     1    Toggle dimensions.
  119.     2    Toggle dimensions.
  120.     e    Use eval mode.
  121.     m    Use mesh mode.
  122.     f    Toggle polygon mode.
  123.     p    Toggle point mode.
  124.     c    Toggle color mode.
  125.     t    Toggle texture mode.
  126.     l    Toggle lighting mode.
  127.  
  128. fog - Fog test.
  129.     - RGBA/CI (RGBA default), SB/DB (SB default), DR/ID (ID default).
  130.     - cmd line options:
  131.     -rgb    RGBA mode.
  132.     -ci    Color index mode.
  133.     -sb    Single buffer mode.
  134.     -db    Double buffer mode.
  135.     -dr    Direct render mode.
  136.     -ir    Indirect render mode.
  137.     - keys:
  138.     ESC    Quit.
  139.     LEFT    Rotate.
  140.     RIGHT    Rotate.
  141.     UP    Rotate.
  142.     DOWN    Rotate.
  143.     D    Increase fog density.
  144.     d    Decrease fog density.
  145.  
  146. font - font test.
  147.     - RGBA/CI (RGBA default), SB/DB (SB default), DR/ID (ID default).
  148.     - cmd line options:
  149.     -rgb    RGBA mode.
  150.     -ci    Color index mode.
  151.     -sb    Single buffer mode.
  152.     -db    Double buffer mode.
  153.     -dr    Direct render mode.
  154.     -ir    Indirect render mode.
  155.     - keys:
  156.     ESC    Quit.
  157.     Left    Shift left.
  158.     Right    Shift right.
  159.     Up    Shift up.
  160.     Down    Shift down.
  161.     n    Shift in.
  162.     m    Shift out.
  163.     q    Scale up x.
  164.     w    Scale down x.
  165.     a    Scale up y.
  166.     s    Scale down y.
  167.     z    Scale up z.
  168.     x    Scale down z.
  169.     e    Rotate clockwise x.
  170.     r    Rotate counter-clockwise x.
  171.     d    Rotate clockwise y.
  172.     f    Rotate counter-clockwise y.
  173.     c    Rotate clockwise z.
  174.     v    Rotate counter-clockwise z.
  175.  
  176. line - Line test.
  177.     - RGBA/CI (RGBA default), SB/DB (SB default), DR/ID (ID default).
  178.     - cmd line options:
  179.     -rgb    RGBA mode.
  180.     -ci    Color index mode.
  181.     -sb    Single buffer mode.
  182.     -db    Double buffer mode.
  183.     -dr    Direct render mode.
  184.     -ir    Indirect render mode.
  185.     - keys:
  186.     ESC    Quit.
  187.     W    Increase line width.
  188.     w    Decrease line width.
  189.     1    Toggle stipple mode.
  190.     2    Toggle anti-aliased mode.
  191.  
  192. logo - Demo.
  193.     - RGBA/CI (RGBA default), SB/DB (SB default), DR/ID (ID default).
  194.     - cmd line options:
  195.     -rgb    RGBA mode.
  196.     -ci    Color index mode.
  197.     -sb    Single buffer mode.
  198.     -db    Double buffer mode.
  199.     -dr    Direct render mode.
  200.     -ir    Indirect render mode.
  201.     - keys:
  202.     ESC    Quit.
  203.     LEFT    Rotate.
  204.     RIGHT    Rotate
  205.     UP    Move clipping plane.
  206.     DOWN    Move clipping plane.
  207.     Z    Translate.
  208.     z    Translate.
  209.     1    Use GL_POINT polygon mode.
  210.     2    Use GL_LINE polygon mode.
  211.     3    Use GL_FILL polygon mode.
  212.     p    Toggle polygon fill modes.
  213.     4    Use GL_NICEST for GL_POLYGON_SMOOTH_HINT.
  214.     5    Use anti-aliased polygon mode.
  215.     6    Use aliased polygon mode.
  216.     8    Toggle dither mode.
  217.     9    Toggle stipple polygon mode.
  218.     0    Toggle flat/smooth shading mode.
  219.     q    Disable cull mode.
  220.     w    Use front face cull mode.
  221.     e    Use back face cull mode.
  222.     r    Use clockwise front face mode.
  223.     t     Use counter-clockwise front face mode.
  224.     y    Use MSB first stipple pattern.
  225.     u    Use LSB first stipple pattern.
  226.     a    Use brick texture map.
  227.     s    Use checker texture map.
  228.     d    Disable texture map.
  229.     f    Use decal texture environment mode.
  230.     g    Use modulate texture environment mode.
  231.  
  232. nurb - Nurb test.
  233.     - RGBA, SB/DB (SB default), DR/ID (ID default).
  234.     - cmd line options:
  235.     -sb    Single buffer mode.
  236.     -db    Double buffer mode.
  237.     -dr    Direct render mode.
  238.     -ir    Indirect render mode.
  239.     - keys:
  240.     ESC    Quit.
  241.     LEFT    Rotate.
  242.     RIGHT    Rotate.
  243.     UP    Rotate.
  244.     DOWN    Rotate.
  245.  
  246. olympic - Olymipic rings demo.
  247.     - RGBA/CI (RGBA default), SB/DB (SB default), DR/ID (ID default).
  248.     - cmd line options:
  249.     -rgb    RGBA mode.
  250.     -ci    Color index mode.
  251.     -sb    Single buffer mode.
  252.     -db    Double buffer mode.
  253.     -dr    Direct render mode.
  254.     -ir    Indirect render mode.
  255.     - keys:
  256.     ESC    Quit.
  257.     SPACE    Restart demo.
  258.  
  259. overlay - Overlay plane demo.
  260.     - RGBA, SB/DB (SB default), DR/ID (ID default).
  261.     - cmd line options:
  262.     -sb    Single buffer mode.
  263.     -db    Double buffer mode.
  264.     -dr    Direct render mode.
  265.     -ir    Indirect render mode.
  266.     - keys:
  267.     ESC    Quit.
  268.     SPACE    Toggle star weird movement mode.
  269.     t    Toggle star turbo mode.
  270.  
  271. point - Point test.
  272.     - RGBA/CI (RGBA default), SB/DB (SB default), DR/ID (ID default).
  273.     - cmd line options:
  274.     -rgb    RGBA mode.
  275.     -ci    Color index mode.
  276.     -sb    Single buffer mode.
  277.     -db    Double buffer mode.
  278.     -dr    Direct render mode.
  279.     -ir    Indirect render mode.
  280.     - keys:
  281.     ESC    Quit.
  282.     LEFT    Translate.
  283.     RIGHT    Translate.
  284.     UP    Translate.
  285.     DOWN    Translate.
  286.     W    Increase point width.
  287.     w    Decrease point width.
  288.     1    Toggle anti-aliased mode.
  289.  
  290. prim - Primitive test.
  291.     - RGBA/CI (RGBA default), SB/DB (SB default), DR/ID (ID default).
  292.     - cmd line options:
  293.     -rgb    RGBA mode.
  294.     -ci    Color index mode.
  295.     -sb    Single buffer mode.
  296.     -db    Double buffer mode.
  297.     -dr    Direct render mode.
  298.     -ir    Indirect render mode.
  299.     - keys:
  300.     ESC    Quit.
  301.     1    Toggle flat/smooth shade mode.
  302.     2    Toggle outlined/filled polygon mode.
  303.     3    Toggle color mask mode.
  304.  
  305. quad - Quadric test.
  306.     - RGBA/CI (RGBA default), SB/DB (SB default), DR/ID (ID default).
  307.     - cmd line options:
  308.     -rgb        RGBA mode.
  309.     -ci        Color index mode.
  310.     -sb        Single buffer mode.
  311.     -db        Double buffer mode.
  312.     -dr        Direct render mode.
  313.     -ir        Indirect render mode.
  314.     -f <file name>    texture file.
  315.     - keys:
  316.     ESC        Quit.
  317.     LEFT        Rotate.
  318.     RIGHT        Rotate.
  319.     UP        Rotate.
  320.     DOWN        Rotate.
  321.     X        Rotate.
  322.     x        Rotate.
  323.     1        Use GLU_FILL draw style.
  324.     2        Use GLU_POINT draw style.
  325.     3        Use GLU_LINE draw style.
  326.     4        Use GLU_SILHOUETTE draw style.
  327.     0        Toggle flat/smooth shade mode.
  328.     f        Cylce through quadrics.
  329.     d        Toggle orientation.
  330.     A        Increase number of stacks.
  331.     a        Decrease number of stacks.
  332.     S        Increase number of slices.
  333.     s        Decrease number of slices.
  334.     G        Increase radius1.
  335.     g        Decrease radius1.
  336.     J        Increase radius2.
  337.     j        Decrease radius2.
  338.     H        Increase height.
  339.     h        Decrease height.
  340.     K        Increase angle1.
  341.     k        Decrease angle1.
  342.     L        Increase angle2.
  343.     l        Decrease angle2.
  344.     z        Toggle texture mode.
  345.     q        Disable cull mode.
  346.     w        Use front face cull mode.
  347.     e        Use back face cull mode.
  348.     r        Use clockwise front face mode.
  349.     t         Use counter-clockwise front face mode.
  350.     y        Toggle dither mode.
  351.  
  352. select - Selection test.
  353.     - RGBA, SB, DR/ID (ID default).
  354.     - cmd line options:
  355.     -dr    Direct render mode.
  356.     -ir    Indirect render mode.
  357.     - keys:
  358.     ESC    Quit.
  359.     LEFT    Rotate.
  360.     RIGHT    Rotate.
  361.     Z    Increase zoom factor.
  362.     z    Decrease zoom factor.
  363.     d    Zoom at current mouse location.
  364.     f    Print feedback information.
  365.     l    Toggle outlined/filled polygon mode.
  366.     - mouse:
  367.     Left    Recolor selected triangle.
  368.     Center    Enlarge selected triangle.
  369.     Right    Delete selected triangle.
  370.  
  371. shape - shape test.
  372.     - RGBA/CI (RGBA default), SB/DB (SB default), DR/ID (ID default).
  373.     - cmd line options:
  374.     -rgb    RGBA mode.
  375.     -ci    Color index mode.
  376.     -sb    Single buffer mode.
  377.     -db    Double buffer mode.
  378.     -dr    Direct render mode.
  379.     -ir    Indirect render mode.
  380.     - keys:
  381.     ESC    Quit.
  382.     Left    Shift left.
  383.     Right    Shift right.
  384.     Up    Shift up.
  385.     Down    Shift down.
  386.     n    Shift in.
  387.     m    Shift out.
  388.     q    Scale up x.
  389.     w    Scale down x.
  390.     a    Scale up y.
  391.     s    Scale down y.
  392.     z    Scale up z.
  393.     x    Scale down z.
  394.     e    Rotate clockwise x.
  395.     r    Rotate counter-clockwise x.
  396.     d    Rotate clockwise y.
  397.     f    Rotate counter-clockwise y.
  398.     c    Rotate clockwise z.
  399.     v    Rotate counter-clockwise z.
  400.     SPACE    switch shapes.
  401.  
  402. speed - Speed test.
  403.     - RGBA/CI (RGBA default), SB/DB (SB default).
  404.     - cmd line options:
  405.     -rgb    RGBA mode.
  406.     -ci    Color index mode.
  407.     -sb    Single buffer mode.
  408.     -db    Double buffer mode.
  409.     -dr    Direct render mode.
  410.     -ir    Indirect render mode.
  411.     - keys:
  412.     ESC    Quit.
  413.     a    Toggle anti-aliased mode.
  414.     d    Toggle z buffering mode.
  415.     f    Toggle fog mode.
  416.     F    Toggle fog hint mode.
  417.     s    Toggle flat/smooth shading mode.
  418.     t    Toggle texturing mode.
  419.  
  420. sphere - Spheremap test.
  421.     - RGBA, SB/DB (SB default), DR/ID (ID default).
  422.     - cmd line options:
  423.     -sb        Single buffer mode.
  424.     -db        Double buffer mode.
  425.     -dr        Direct render mode.
  426.     -ir        Indirect render mode.
  427.     -f <file name>    texture file.
  428.     -3        Use RGB components.
  429.     -4        Use RGBA components.
  430.     - keys:
  431.     ESC        Quit.
  432.         LEFT        Rotate about the y axis.
  433.         RIGHT        Rotate about the y axis.
  434.         UP        Rotate about the x axis.
  435.         DOWN        Rotate about the x axis.
  436.         a        Toggle auto rotate mode.
  437.         c        toggle between cylinder or cube object.
  438.         t        Use torus object.
  439.         d        Use decal texture mode.
  440.           m        Use modulate texture mode.
  441.         l        Toggle lighted mode.
  442.         f        Toggle fog mode.
  443.         0        Use nearest magification filter.
  444.         1        Use linear magification.
  445.         2        Use nearest minification filter.
  446.         3        Use linear minification filter. 
  447.         4        Use nearest-mipmap-nearest minification filter. 
  448.         5        Use nearest-mipmap-linear minification filter. 
  449.         6        Use linear-mipmap-nearest minification filter. 
  450.         7        Use linear-mipmap-linear minification filter. 
  451.  
  452. star - Demo.
  453.     - RGBA, SB/DB (SB default), DR/ID (ID default).
  454.     - cmd line options:
  455.     -sb    Single buffer mode.
  456.     -db    Double buffer mode.
  457.     -dr    Direct render mode.
  458.     -ir    Indirect render mode.
  459.     - keys:
  460.     ESC    Quit.
  461.     SPACE    Toggle weird movement mode.
  462.     t    Toggle turbo mode.
  463.  
  464. stencil - Stencil test.
  465.     - RGBA, SB, DR/ID (ID default).
  466.     - cmd line options:
  467.     -dr    Direct render mode.
  468.     -ir    Indirect render mode.
  469.  
  470. stretch - Texture test.
  471.     - RGBA, SB, DR/ID (ID default).
  472.     - cmd line options:
  473.     -sb        Single buffer mode.
  474.     -db        Double buffer mode.
  475.     -dr        Direct render mode.
  476.     -ir        Indirect render mode.
  477.     -f <file name>    texture file.
  478.     - keys:
  479.     ESC        Quit.
  480.     SPACE        Start animation.
  481.     - mouse:
  482.     Left        Added stretch point.
  483.  
  484. texture - Texture test.
  485.     - RGBA, SB/DB (SB default), DR/ID (ID default).
  486.     - cmd line options:
  487.     -sb        Single buffer mode.
  488.     -db        Double buffer mode.
  489.     -dr        Direct render mode.
  490.     -ir        Indirect render mode.
  491.     -f <file name>    texture file.
  492.     - keys:
  493.     ESC        Quit.
  494.     LEFT        Rotate.
  495.     RIGHT        Rotate.
  496.     UP        Rotate.
  497.     DOWN        Rotate.
  498.     T        Translate.
  499.     t        Translate.
  500.     s        Toggle sphere map mode.
  501.     0        Use nearest magification filter.
  502.     1        Use linear magification filter.
  503.     2        Use nearest minification filter.
  504.     3        Use linear minification filter.
  505.     4        Use nearest-mipmap-nearest minification filter.
  506.     5        Use nearest-mipmap-linear minification filter.
  507.     6        Use linear-mipmap-nearest minification filter.
  508.     7        Use linear-mipmap-linear minification filter.
  509.  
  510. tri - Triangle test.
  511.     - RGBA/CI (RGBA default), SB/DB (SB default), DR/ID (ID default).
  512.     - cmd line options:
  513.     -rgb    RGBA mode.
  514.     -ci    Color index mode.
  515.     -sb    Single buffer mode.
  516.     -db    Double buffer mode.
  517.     -dr    Direct render mode.
  518.     -ir    Indirect render mode.
  519.     - keys:
  520.     ESC    Quit.
  521.     LEFT    Translate.
  522.     RIGHT    Translate.
  523.     Z    Increase zoom factor.
  524.     z    Decrease zoom factor.
  525.     1    Use point polygon mode.
  526.     2    Use line polygon mode.
  527.     3    Use filled polygon mode.
  528.     4    Use point primitive.
  529.     5    Use line-loop primitive.
  530.     6    Use polygon primitive.
  531.     7    Toggle cull mode.
  532.     8    Use clockwise/counter-clockwise front face mode.
  533.     9    Toggle front/back face cull mode.
  534.     v    Toggle show verticies mode.
  535.     s    Toggle flat/smooth shade mode.
  536.     h    Toggle hide bottom triangle mode.
  537.     o    Toggle outline mode.
  538.     m    Toggle dither mode.
  539.     0    Toggle anti-aliased mode.
  540.  
  541. wave - Demo.
  542.     - RGBA/CI (RGBA default), SB/DB (SB default), DR/ID (ID default).
  543.     - cmd line options:
  544.     -rgb        RGBA mode.
  545.     -ci        Color index mode.
  546.     -sb        Single buffer mode.
  547.     -db        Double buffer mode.
  548.     -dr        Direct render mode.
  549.     -ir        Indirect render mode.
  550.     -grid <x> <y>    Number of grids.
  551.     -size <number>    Size of grid.
  552.     -wave <number>    Height of wave (floating point number).
  553.     -frames <count>    Number of frames.
  554.     - keys:
  555.     ESC        Quit.
  556.     c        Toggle contouring mode.
  557.     s        Toggle flat/smooth shade mode.
  558.     l        Toggle lighting mode.
  559.     d        Toggle depth checking mode.
  560.     SPACE        Toggle step/animation mode.
  561.     n        Single step in step mode.
  562.     a        Toggle spin mode.
  563.